package com.example.auth.demo.config;

import com.example.auth.demo.domain.ResultCode;
import com.example.auth.demo.domain.ResultJson;
import org.springframework.security.access.AccessDeniedException;
import org.springframework.security.web.access.AccessDeniedHandler;
import org.springframework.stereotype.Component;

import javax.servlet.ServletException;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.PrintWriter;

/**
 * REST风格的权限不足处理器
 * 当已认证用户尝试访问需要更高权限的资源时，此处理器会被触发
 * 返回JSON格式的错误响应，而不是默认的HTML错误页面
 * 适用于前后端分离的RESTful API应用
 */
@Component("RestAuthenticationAccessDeniedHandler")
public class RestAuthenticationAccessDeniedHandler implements AccessDeniedHandler {

    /**
     * 处理权限不足的情况
     * 当Spring Security检测到用户权限不足时，会调用此方法
     *
     * @param httpServletRequest 客户端HTTP请求
     * @param response 服务器HTTP响应
     * @param e 权限检查过程中抛出的AccessDeniedException异常
     * @throws IOException 输出响应内容时可能发生的IO异常
     * @throws ServletException 处理请求时可能发生的Servlet异常
     */
    @Override
    public void handle(HttpServletRequest httpServletRequest, HttpServletResponse response, AccessDeniedException e) throws IOException, ServletException {
        // 记录权限不足信息，方便调试和审计
        System.out.println("权限不足：" + e.getMessage());

        // 设置响应状态码为200，使用业务错误码而非HTTP状态码表示权限不足
        // 这是为了与前端约定统一的错误处理机制
        response.setStatus(200);
        // 设置响应字符编码为UTF-8，确保中文等字符正确显示
        response.setCharacterEncoding("UTF-8");
        // 设置响应内容类型为JSON格式
        response.setContentType("application/json; charset=utf-8");

        // 获取响应输出流
        PrintWriter printWriter = response.getWriter();
        // 构建统一的JSON错误响应，包含业务错误码(FORBIDDEN)和错误消息
        String body = ResultJson.failure(ResultCode.FORBIDDEN, e.getMessage()).toString();
        // 将错误响应写入输出流
        printWriter.write(body);
        // 刷新输出流确保数据发送
        printWriter.flush();
    }
}